/*
 * Copyright (c) 2020 pig4cloud Authors. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.pig4cloud.pig.auth.support.handler;

import cn.hutool.core.util.CharsetUtil;
import cn.hutool.http.HttpUtil;
import com.pig4cloud.pig.common.core.util.WebUtils;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import lombok.SneakyThrows;
import lombok.extern.slf4j.Slf4j;
import org.springframework.security.core.AuthenticationException;
import org.springframework.security.web.authentication.AuthenticationFailureHandler;

import java.io.IOException;

/**
 * 表单登录失败处理器
 * <p>
 * 该类实现了 Spring Security 的 AuthenticationFailureHandler 接口，
 * 用于处理基于授权码模式的表单登录失败场景。
 * 
 * 主要功能：
 * 1. 记录登录失败日志
 * 2. 构建包含错误信息的重定向 URL
 * 3. 将用户重定向回登录页面并显示错误信息
 * 
 * 使用场景：
 * - OAuth2 授权码模式下的用户名密码认证失败
 * - 登录页面表单提交失败
 *
 * @author lengleng
 * @date 2025/05/30
 */
@Slf4j
public class FormAuthenticationFailureHandler implements AuthenticationFailureHandler {

	/**
	 * 当认证失败时调用
	 * <p>
	 * 处理流程：
	 * 1. 记录失败日志，便于问题排查
	 * 2. 获取应用的 context-path（支持部署在二级路径）
	 * 3. 构建包含错误信息的登录页面 URL
	 * 4. 重定向回登录页面，让用户重新尝试
	 * 
	 * @param request 认证尝试发生的请求
	 * @param response 响应对象
	 * @param exception 拒绝认证时抛出的异常，包含失败原因
	 */
	@Override
	@SneakyThrows
	public void onAuthenticationFailure(HttpServletRequest request, HttpServletResponse response,
			AuthenticationException exception) {
		log.debug("表单登录失败:{}", exception.getLocalizedMessage());

		// 获取当前请求的 context-path
		// 这是为了支持应用部署在二级路径下的情况
		String contextPath = request.getContextPath();

		// 构建重定向 URL
		// 将错误信息作为参数传递给登录页面
		// 使用 HttpUtil.encodeParams 确保 URL 参数被正确编码
		String url = HttpUtil.encodeParams(
				String.format("%s/token/login?error=%s", contextPath, exception.getMessage()),
				CharsetUtil.CHARSET_UTF_8);

		try {
			// 执行重定向
			// 使用 WebUtils.getResponse() 获取当前的 response 对象
			WebUtils.getResponse().sendRedirect(url);
		}
		catch (IOException e) {
			// 重定向失败时记录错误日志
			// 这种情况通常是响应已经被提交或关闭
			log.error("重定向失败", e);
		}
	}

}
